home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / kill.man < prev    next >
Encoding:
Text File  |  1989-01-01  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. KILL                  C Library Procedures                   KILL
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      kill - send signal to a process
  10.  
  11. SSYYNNOOPPSSIISS
  12.      kkiillll((ppiidd,, ssiigg))
  13.      iinntt ppiidd,, ssiigg;;
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      _K_i_l_l sends the signal _s_i_g to a process, specified by the
  17.      process number _p_i_d.  _S_i_g may be one of the signals specified
  18.      in _s_i_g_v_e_c(2), or it may be 0, in which case error checking
  19.      is performed but no signal is actually sent. This can be
  20.      used to check the validity of _p_i_d.
  21.  
  22.      The sending and receiving processes must have the same
  23.      effective user ID, otherwise this call is restricted to the
  24.      super-user.  A single exception is the signal SIGCONT, which
  25.      may always be sent to any descendant of the current process.
  26.  
  27.      If the process number is 0, the signal is sent to all
  28.      processes in the sender's process group; this is a variant
  29.      of _k_i_l_l_p_g(2).
  30.  
  31.      If the process number is -1 and the user is the super-user,
  32.      the signal is broadcast universally except to system
  33.      processes and the process sending the signal.  If the pro-
  34.      cess number is -1 and the user is not the super-user, the
  35.      signal is broadcast universally to all processes with the
  36.      same uid as the user except the process sending the signal.
  37.      No error is returned if any process could be signaled.
  38.  
  39.      For compatibility with System V, if the process number is
  40.      negative but not -1, the signal is sent to all processes
  41.      whose process group ID is equal to the absolute value of the
  42.      process number.  This is a variant of _k_i_l_l_p_g(2).
  43.  
  44.      Processes may send signals to themselves.
  45.  
  46. RREETTUURRNN VVAALLUUEE
  47.      Upon successful completion, a value of 0 is returned.  Oth-
  48.      erwise, a value of -1 is returned and _e_r_r_n_o is set to indi-
  49.      cate the error.
  50.  
  51. EERRRROORRSS
  52.      _K_i_l_l will fail and no signal will be sent if any of the fol-
  53.      lowing occur:
  54.  
  55.      [EINVAL]       _S_i_g is not a valid signal number.
  56.  
  57.      [ESRCH]        No process can be found corresponding to that
  58.                     specified by _p_i_d.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 14, 1986                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. KILL                  C Library Procedures                   KILL
  71.  
  72.  
  73.  
  74.      [ESRCH]        The process id was given as 0 but the sending
  75.                     process does not have a process group.
  76.  
  77.      [EPERM]        The sending process is not the super-user and
  78.                     its effective user id does not match the
  79.                     effective user-id of the receiving process.
  80.                     When signaling a process group, this error
  81.                     was returned if any members of the group
  82.                     could not be signaled.
  83.  
  84. SSEEEE AALLSSOO
  85.      getpid(2), getpgrp(2), killpg(2), sigvec(2)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0               May 14, 1986                          2
  130.  
  131.  
  132.  
  133.